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INTRODUCTION 

This section is an overview of the 2500 A.D. 8748 Crass 
Assembler. The intent of this manual i s to describe the operation 
of the Cross Assembler. It is assumed that the user is familiar 
with the S74S operation and instruction set. 

The 2500 A.D. 8748 Cross As^emhler enables the user to write 
programs on a 8086 based system, which can then be assembled into 
relocatable object code and linked to the desired execution 
address using the 25G0 A.D. LinM-r. Two different syntaxes are 
accepted. The first is the standard 8748 syntax as defined by 
Intel , and the second is a form similar to Zi log's ZSO syntax. 
For users familiar with this syntax, this helps to speed up the 
switch from one processor to another. The mnemonics used for 
either syntax are those defined by Intel. 

The Assembl r will process files as large as the disk stor- 
age device- All buffers including the Symbol Table Buffer over- 
flow to disk. The Macro section handles string comparisons, 
dummy parameter substitution, recursion and nesting limited only 
by the amount of disk storage space available. 

The Conditional Assembly section enables the user to direct 
the Assembler to process different sections of the source file 
depending on the outcome of assembly time operations. 
Conditionals may be nested to 248 levels, and the Assembler aids 
the programmer in detecting conditional nesting errors by not 
only checking for unbalanced conditional levels, but ^lsa by 
displaying the current active conditional level in the ooject 
code field of the lifting. 

The Assembly Time Calculation section will perform 
calculations with up to 16 pending operands, using either 16 or 
32 bit arithmetic. The algebraic hierarchy may be changed 
through the use of parenthesis. 

The Listing Control section provides for listing all or just 
sections of the program, with convenient Assembler error detec- 
tion overrides, along with Assembly Run Time Commands that may be 
used to dynamically change the listing mode. 

The 2500 A.D. Linker allows up to 12S files to either be 
linked together or just used for external reference resolution. 
As with the Assembler, all buffers used by the Linker overflow to 
disk, with the result being that Gl obal s, Externals and object 
code sizes are limited only by the amount of disk storage space 
available. In an effort to accommodate different output require- 
ments, multiple versions of the Linker are provided- See the 
linker action of this manual for a description of the different 
Linkers. 
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87 48 CROSS ASSEMBLER OPERATING INSTRUCTIONS 



PROMPT MODE 

To run the Assembler type : X8743 

The Assembler will r t- n.ud with : 

LISTING DESTINATION ? CT T s LP, DD t NL , DL , EO> 

with the abbreviations as -Follows: 

TI = THr:mnal In,rfiedi ate 

LP - Line Printer 

DD - Disk Drive 

NL - No Listing 

DL = Directive Listing 

> E0 = Error Only 

If the listinq is to be sent to the disk, the Assembler will 
output the -following prompt: 

LISTING DRIVE ? (<CR> = SAME AS OUTPUT FILE) 

The user may enter a drive letter or just a carri < je return, 
which will send the listing to the same drive that the output 
file is going to be sent to. The listing file always receives 
the same name as the input file with an extension of L3T. Also, 
when the listinq is being sont to the disk, an additional tab is 
inserted between the end of the object code field and the start 
of the label fi -id so that when the file is printed. the tabs 
will be expandec properly. 

After this the Assembler prompts the operator for the source 
code filename as shown below. 

INPUT FILENAME ? : 

Finally, the Assembler asks for the output filename. 

OUTPUT FILENAME 1 : 

If the user repsonds to the ^hove prompt with just a 
carriage return, the output file will receive the same filename 
as the input file, with an extension of OBJ. If the response is 
just a drive letter followed by a colon, the output will be sent 
to that drive with the same filename as the input file, with an 
extension of OB J . If the r epsonse is a filename with no 
extension, the output file will he under that filename with an 
extension of OBJ - 



- 
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VERSION 3.00 



It the listing is to be under as^oibier directive control 
the additional prompt shown below is output: 

ASSEMBLER DIRECTIVE LISTING DESTINATION ? <TI.LP,DD> 

The directive control li ting allows the user to output only 
the part of i-tt assembly specified by LIST OH/ OFF . For more 
information on LIST ON /OFF see the listing control section. 

Cross Reference generates a listing that allows the user to 
locate symbols used anywhere in the program. 

If Error Only is chosen the following destinations wi 1 1 he 
shown - 



ASSEMBLER DIRECTIVE LSITITMS DESTINATION ? iTT.LP,DD> 
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COMMAND LINE MODE 

The Assembler may also be invoked using a command line 
format. This mode is useful for Submit type processing- The c illy 
difference in the operation of the command line mode as compared 
with the prompt mode is that the responses to the prompts are 
included in the o_-,**nand line, with each response separated by 
either spaces or a comma as shown below. 

X37A3 1 i st i nq dest i nat a on, i nput _f i 1 ename, output _f i 1 ename 

For example, if the input f i 1 en ne is TEST- SRC, the output 
filename is TEST. OBJ ^nd no lifting is desired the command line 
would be: 

XS748 NL TEST. SRC TEST. OBJ 

or 

X8748 NL , TEST . SRC , TEST - OBJ 

If the file contains conditional listing directives, and the 
specified sections are to be sent to the line printer, and cross 
reference is not specified then the following command line wouici 
be issued (assuming the same filenames as above) : 

X874S DL LP N TEST . SRC TEST- OBJ 

If it w^s desired to send the listing in the above example 
to the disk instead of to the printer, the following command line 
would be issued: 

XS748 DL DD A N TEST. SRC TEST. OBJ 

Note that the listing drive number is included in the 
command line. If you want the listing to go to the same drive 
as the output file, then a command line using commas as place 
holders must be used as shown below. 

X8748 DL, DD, , M, TEST. SRC, TEST. OBJ 

If the *.ASK* assembler directive is used, the responses 
must be appended in the proper order at the end of the command 
line. For example, if in the last example the file contained two 
1 . ASK * directives which would be repsonded to wit* a O and a 1 
then the following command line would be issued: 

X8743 DL LP TEST. SRC TEST. OBJ O 1 



The command line buffer is 1 28 byi *- j s long and no checks e 
made for overflow. Also, note that the Assembler Run Time 
Listing Commands interrogate only the console and cannot be 
controlled through a Submit file. However, they are active 
during Submit file processing. 
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SYSTEM DEFAULTS 



The following default filename extensions will be used by 
the 2500 A.D. programs if no extension is specified by the user. 



ASM - Input to the Assembler 

OBJ - Output from the Assembler 

LST - Listing file 

OBJ - Input to the Linker 

TSK - Output from LINK I 

HEX - Output from LINK2 



Note that because of the additional information included in 
the Assembler output file, the Linker must always be run, even 
if the program is assembled at the desired run address and there 
are no external references. This is just so that all the addi- 
tional information can be removed and a lo^d file can be geoef — 
ated. 



ASSEMBLER RUN T I HE COMMANDS 



The following commands are active during the assembly pro- 
cess. Before parsing each line, the console is checked for 
input- These commands are active during pass 1 as well as pass 
2, avid override the listing mode specified when the Assembler was 
first activated. The * symbol denotes pressing the control key 
simultaneously with the letter key. 



"^S m Alternately start and stop the assembly 

Z - Terminate the assembly 

A T m Display the output at the terminal 

A P m Display the output at the printer 

- V D ~ Send the output to the disk 

•^B = Both terminal & printer or disk 

= Turn off the output display 



When the ^B selection is used, if the listing is currently 
being displayed at the terminal, the printer is included- If the 
listing is currently being sent to the printer, the terminal is 
included. If the listing is being s,=nt to the disk, the terminal 
is included. If the function is used, and the disk file has 

not been created yet, the Assembler will create it before it 
continues with the assembly. 
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ASSEMBLY ERROR PROCESS I NO 

When an assembly error is encountered, the action taken by 
the Assembler depends on the lifting mode it is currently oper- 
ating under. 

If the No LJ st option was specified, the statement causing 
the error and the error <Ti(?ssage will be output to the terminal, 
the display will be turne i on and the Assembler will halt just as 
if the user had typed ^S- The reason for this is to give the user 
a chance to see exactly where the error is- This will occur on 
pass 1 as well as pass 2. Note that some errors are not detect- 
able on pass 1, such as undefined symbol = - After the error has 
been displayed, the output can be turned t ,f using N* 

If the listing is being sent to the printer, then error? 
encountered on pass 1 are sent to the terminal but not the print- 
er, and the Assembler does not halt. On pass 2, the error is 
output to the printer as well as the terminal and the assembly 
continues . 

If the listing is being s^nt to the printer under assembler 
directive control, any errors encountered during pass 1 are 
output to the terminal but not the printer, and the assembly 
continues. Errors detected during pass 2 are output to \ ( e 
printer and the terminal, ev^n if the error is not inside a block 
that was specified to be lifted. 

Because of the action taken by the Assembler outside of LIST 
ON/OFF blocks when Directive Listing is specified, error only 
outputs can be obtained by removing all LIST ON/OKF blocks and 
specifying Directive Listing <DL) for output destination. 

A Symbol Table is output when the listing destination is 
either the disk or the printer. The Symbol Table is not output 
to the terminal unless the output is being sent to both the 
terminal and the printer or the terminal and the disk. If the 
output is under Assembler Directive control, the Sy-nbol Table i E 
output if a LIST ON block is being processed when the end of the 
program is reached- Otherwise, the Symbol Table is not output. 
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ASSEMBLER FILE HANDLING DESCRIPTION 

During the Assembly process the Assembler manipulates > he 
f ol 1 owi ng f i 1 es: 

- The file containing the program 
source code. 

- The output file from the assembler 
containing object c- dp, address re— 
location information, External and 
Global symbols with pectinate ad- 
dress information and program entry 
point .iformation. 

- This is a temporary file used to 
hold the address relocation informa- 
tion during the assembly. 

- This file is used when the symbol 
table overflows- The table overflows 
at about 550 symbols. 

This file is used to store the nacro 
names when the Macro table over- 
flows. The table overflows after 204 
i acros have been defined- 

- This file is used to store the Hacro 
definitions and dummy parameter 
lists. The parameter list may be up 
to SO characters- Also, chis file 
holds information for macro nesting, 
which is limited only by the size of 
the disk. 

eternal Symbol" file - This file holds information concern- 
ing the address of External symbols 
used in the program. 

With the exception of the Source file, all the fiies are 
stored on the same drive as the Object file. Since every buf "er 
used by the assembler overflows to disk, the only limit to the 
size of the program that can be assembled is the amount of disk 
space avai 1 abl e. 

At the end of Pass 1, the Assembler searches the Symbol 
Table for multiply defint-d symbols. For programs with less than 
about 600 symbols, this search time is not not i cable. ror pro- 
grams at or above this threshold the user may notice a period of 
a few seconds where it appears that the Assembler quit running. 
The purpose of this notice is to prevent the user from having 
heart failure over this event. 



Source file 
Object file 

Relocation file 
Symbol Table file 
Macr o Tabl e file 

Macro Buffer file 



7 



2300 A, D. 874S CROSS ASSEMBLER K3DQ3 Sc OPtl 86- VERSION 3- CO 



S748 ASSEMBLY LANGUAGE SYNTAX 

This section describes the syntax used by the 2500 A- D. 
Cross Assembler. 



NUMBER BASE DESIGNATIONS 

Number bases ^re specified by the fallowing: 

Bi nary — B 

Octal - Q 

Decimal - D or no base designation 

HEX - H 

ASCII - M X" or * X* 

ASCII special cases -for program clarity: 

"CR" or ? CR* - Carriage return 

*" LF '* or ? LF" - Line feed 

"SP" or *SP 7 ~ Space 

"HT" or y HT y - Horizontal tab 

■ML" or * NL * ~ Null 



PROGRAM COMMENTS 

Comment lines must start with a semi— colon in column i, 
unless the - * COMMENT" directive is used. Comments after an in- 
struction do not need a serni -colon if at least 1 space or tab 
preceeds the start of the comment. 



LABI US 

Labels may be any number of characters long, but only iO 
characters are significant. I -hels may start in any column if 
the name is terminated by a colon. If no colon is used, the 
label must start in column 1- All labels must start with an 
alpha character, Upper and lower case characters are considered 
to be different. 



PROGRAM COUNTER (*) 

The special character ? % * me»y be vised in an expression to 
specify the program counter. The value assigned to th I dollar 
sign is the program counter value at the start of the instruction. 



B 
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UPPER/LOWER CASE 

All mnemonics and register specifications must use '_ipper 
case characters. Lower and upper case characters in labels are 
considered to be different. Hexadecimal characters must be upper 
case- Included with this p ck-ge is a program called * CASE. COh r 
to convert source code from 1 o^u'r to upper case. In contrast with 
most general purpose routines that perform this function, Case's 
claim to fame is that it will U.^ve A^ri i stri ngs hracfce 1 E-d with 
apostrophes alone. Note however, that it will change all labei 
characters to upper c."_e. See the Converter Operating Instruc- 
tions section of this manual fur- i_! u .jf t his nt-ility. 
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ADDRESSING MODES 



The 8748 addressing modes are listed below, along with 
examples of each type. The Cross Assembler will accept either or 
the two different syntaxes shown for Immediate and Register 
Indirect mode. 



IMMEDIATE 

The data is contained in the instruction. 
Examples: 

MOV A,#12H ; Load A with the Hex Number i2 

MOV A ? 4U2H ; Same as ^bove with optional # sign 

MOV A, #DATA ; Ld A with the value associated 

with the label DATA 

REriSTER 

The data is contained in a CPU register. 
Examples: 

MOV R0 5 A ; J.d the contents in register h into 

register RO 

INC RO ; Increment the contents of register 

RO by one 



REGISTER INDIRECT 

The address of the operand is pointed to by the contents or 
a register. 

Ex amples: 

MOV A,S>RO ; Load A with the contents of the 

memory location pointed '.a by RO 

MOV A, <RO) ; Same instruction as above, with 

the second Register Indirect lortn 



DIRECT ADDRESS 

The address of the operand is contained in the instruction. 
Ex amp 1 es: 

JhP ADDRESS ; Jump to the location * ADDRE55 r 



lO 



2500 A. D. 8748 CROSS ASSEMBLER MS DOS & CPU 86- VERSION 3.00 



ASSEMBLER DIRECTIVES 

This section describes the Ass^nbler Directives- Directives 
may be preceeded by a decimal point if desired to help 
differentiate them from program instructions. 

STORAGE CONTROL 

0R6 EXP 
ORIGIN 

Sets the program ass*^N»bly address. If this directive is not 
ex» cuted, the assembly address defaults to OOOO. 



END 

Defines the end of the program- Every program mu^fc have an 
END statement, and every program INCLUDED in the assembly must 
have an END statement. 



LABEL: DB EXP 

DE B 
BY IE 
STRIM 

The Assembler will store the value of the expression in 
consecutive memory locations. The BYTE expression may be any 
mixture of operand types with each one spearated by a co^ma- 
Ascii character strings must be bracketed by apostrophes- If the 
string contains an apostrophe, this can be specified with two 
apostrophes in a rr-w. If no expression is given, one byt B is 
reserved and zeroed- A label is optional. 



BYTE 
BYTE 
BYTE 

BYTE 



BYTE 



-BYTE 



to 

SYMBOL-ID 



'Hello' 



'VWIo* ODH 



BYTE 



*250O A. D. 



; Reserves 1 zeroed byte, 

; Reserves 1 byte = id decimal. 

; Reserves 5 bytes, = to 1,2 it 
3 in that order. 

; Searches the symbol trthle for 
SYMBOL, subtracts iO decimal 
from it's value, and stores 
the result. 

; Stores the Asc i i equivalent 
of the string Heiio in con- 
seruti ve roemor y 1 oc at i ons . 

; 3 MHi as above example, with 
•-he addition of a carriage 
r eturn at the end- Spaces sre 
ignored before operands, but 
the comma is required. 

; Embedded apostrophe. 
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LABEL: DW EXP 

DEFW 
WORD 

Operates exactly as BYTE except a full word is used -For e=tch 
operand- The value is stored most significant byte first. A 
label is optional. 



LABEL: 



LWORD 
LONGU 



E CP 



Operates exactly as BYTE except a 1 on< 
used for each operand- The value is stored as 
BYTE O - BITS - 7 
BYTE 1 - BITS 8-15 
BYTE 2 m BITS 16-23 
BYTE 3 * BITS 24 - 31 
A label is optional. 



word (32 
f ol 1 c< ;s : 



bits) i-i 



LABEL : 



ASCI I 



STRING 



Stores STRING in memory up 
carriage return or a " ! " <Hh"X 7C) 
are some examples of ASCI I - 



to but not including either ^ 
A l^bel is optional. Fallowing 



ASCI I 



K.-l lo 



ASCII 



ASCII 



Hel 1 o { 



Hel 1 o 



; Stores the Ascii representa^ 
tion of Hello in cor secutive 
memory locations. Incidental - 
ly, this comment would be 
stored also. 

; Now the comment wouldn't be 
stored- The next example 

shows termination with just a 
carriage return. 



L A 3 EL : DS EXP 

DEFS 
BLKB 

Reserves the number of bytes «sp. i f i ed by 'EXP'- The reserv- 
ed bytes are set equal to 0. A 1 *bel is optional. 



LABEL: BLKU EXP 

Reserves the number of words specified by * EXP' . Tne reserv- 
ed words are zeroed- A label is optional. 
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DEFINITION CONTROL 

LABEL: EQU EXP 

EQUAL 

Equates * LABEL * to the value of 'EXP* - 



LABEL: VAR EXP 

DEFL 

Equates 'LABEL* to * EXP' but way be changed as often as 
desired throughout the pr otjr^m- A label defined as a variable 
should not be redefined by an * EQUAL' directive. 



LABEL: MACRO ARBS 

Specifies the start of a Macro Definition. 



ENDM 
MACEND 

Specifies t e end of a Macro Definition. 



MACEXIT 

This direc ive causes the immediate exit from a macro- The 
difference between MACEXIT and MACEND is that during the macro 
definition process, MACEXIT does not terminate the macro* and if 
MACEXIT is in the path of a false conditional assembly block, it 
is not executed. 



EXTERN LABEL 
EXTERNAL 

Specifies the label as being defined in another program. 
Multiple labels may be specified as long as R*<_h one is separated 
by a comma. 
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GLOBAL LABEL 
PUBLIC 

Specifics the label as a global label that may be reterencsd 
by other prtgram?. Multiple labels may be specified as long as 
each one is separated by a comma. Below are some examples of fch« 
correct use of GLOBAL. 

GLOBAL SYM1 ;Declares the label 5VHi to be 

accessible to other programs. 
The I inhti wiii resolve the 
Lxter.-al references. 

GLOBAL SYM1, SYM2 ; Multiple declarations on the 

same line are legal if sepa- 
rated by a comma. The spaces 
are ignored. 



LABEL: ASK PROMPT 

Outputs "PROMPT* to the terminal and waits for a i character 
response, from which 30 hex is subtracted. The purpose of this is 
usually to introduce a O/ 1 flag into the prooj ^m- "i h r^ i_ r is — t 
equal to the result. A carl i ^ye return terminates 'PROMPT'. On 
pass 2, the line is output along with the response. 

The following is an example of * A ^>K 1 : 

DISKjSIZE: ASK ASSEMBLE FOR 8" (-1) CR 5 1/4" DRIvES 7 I 
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ASSEMBLY MODE 

RADIX tXP 

Sets the Assembler number base as fallows: 

2 or B ~ Binary 
8 or Q — Octal 
10 or D - Decimal 
16 or H = Hexadecimal 
No expression m return to default mode which is base 10, 
and assume ail others will b© designated with B ? Q, D or H 
after the constant. 



CODE 

Specifies the start of a program instruction section- This 
directive can be used in conjunction with the DATA directive to 
generate separate Code and Data program sections- The Assembler 
initially defaults to a CUDE section. See the Linker Operating 
Instructions section of this manual for information on the 
different ways the Linker can be directed to process Code and 
Data sections. 



DATA 

Specifies the start of a program data section. This dir -z~ 
tive can be used in conjunction with the CODE directive to 
generate separate Code and Data program sections- The Assembler 
initially defaults to a CODE section. See the Linker Operating 
Instructions section of this manual for information on the 
different ways the Linker can be directed to process Code and 
Data sections. 



MOD32 ON 

This directive specifies the precision of intermedia re as- 
sembly time calculations. The Assembler defaults to i6 bit 
calculations. Executing this directive causes the Assembler to 
perform all calculations using 32 bits. This directive is useful 
when intermediate calculation results may be larger than ics bit = , 
and overflow w uld result. The final result however, is a 16 bit 
result and is stored as such. See the Assembly Time Calculations 
section of this manual for a further discussion of these two 
different calculation modes. 



15 



2500 A. D_ 8748 CROSS ASSEMBLER MSDOS & CPtl B£- VERSION 3.00 



MOD32 OFF 

This directive returns the Assembler to the detauit mode of 
using only 16 bits for all assembly time calculations. See the 
Assembly Time Calculations section of this manual -for a further 
discussion of the two different calculation modes. 



COMMENT X 

Directs the Assembler to consider all lines starting eith 
this one until the next * X* to be comments- * X* can be any 
character . 



INCLUDE filename 

Directs the Assembler to include the named file in the 
mbly. If no drive name is specified, the Assembler wi I I 
begin searching for the file starting with drive A - If a drive 
is specified, the Assembler will begin the search with that 
drive. Filename extensions must be completely sp^ci-fied. Inc j i uJvte 
may not be nested. Each file included must have an END state— 
.ut nt. The default number of drives is 2 y but ini s vai^e may be 
changed with the "DRIVES" directive. Below are some f? ^mples of 
the use of this directive. 

INCLUDE FILE -ASM 
I NCLUDE A: FILE- ASM 
1 NCLUDE B: FILE. ASM 

The first two examples are the same* The Assembler does not 
need to find the file on drive A; the drive name simply specifies 
which drive the Assembler should start searching from. The third 
example will start the search from drive B, so i f the file is on 
drive A the Assembler will not find it, and wi i i terminate the 
Assembly. 



DRIVES EXP 

This directive can be used to tell the Assembler how many 
drives are in the system. This is used only for included files 
and it enables the Assembler to make a clean exit (deleting aii 
Assembler generated files) when it t:^n ? t find the Include file. 
If used, this directive should appear bef ore an :I i h*n iufE" direc- 
tive- If only one drive exists ^nd this directive is not use* 1 , a 
BDOS error will be generated by the operating system if the -rile 
is not found. The default number of drives is 2. 
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CONDITIONAL ASSEMBLY 
IFZ EXP 

The Assembler will assemble the statements -following the 
directive up to an ELSE or END IF directive if the value of EXr 
is equal to zero. Conditional statements may be nestea up to 
1 evel S, 



li NZ EXP 
COND 

Assemble tt 3 statements following the directive up to - n 
ELSE or END IF diret tive if the value of EXP is not pqual to zero- 
Conditional statements may be nested up to 248 levels. 



IFTRUE EXP 

This directive is actually the same as IFNZ, but is we 
logical when using assembly time comparisons. If the specified 
condition is true, then the following statements are assembled up 
to an ELSE or ENDIF directive- If the condition is nut true, the 
statements up to an ELSE or END1F directive are not assembled. 



IFFALSE EXP 

This directive is the same as IFZ, and is the complement to 
IFTRUE- If the specified cc idition is false, then the following 
statements are assembled up to an ELSE or ENDIF directive. If 
the condition is true, then the statements up to an ELSE or ENDIF 
directive are not assembled. 



IFDEF LABEL 

This directive will activate a symbol table search, and if 
LABEL is found, then the statements following this one up to an 
ELSE or ENDIF directive will he assembled. if Lhj&EL is not 
found, then the statements following this statement up to an ELSE 
or ENDIF directive will not be assembled. 
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IFNDEF LABEL 

This directive is the complement Q-f IFDEF. The 5\ iboi table 
is searched and if LAPEL is not found, the statements following 
this one up to an ELSE or I NO IF directive are assembled- if 
LABEL is found, then the statements following this one up to an 
ELSE or END IF directive are not assembled. 



I FSAHE STRING 1 , STRING2 

This directive compares STRING1 to STRING2, and conditional- 
ly assembles the statements following this st at <- -men t depending on 
the result of the comparison- If the two strings are identic?! 
then the statements up to an ELSE or END IF directive are assem- 
bled. If the strings are not identical, then the statements up 
to an ELSE or END IF directive are not assembled- The strings i *y 
be one of two different types, namely with spaces or without 
spaces. However, both strings being compared must be of the same 
type- If the strings contain spaces, then the beginning and end 
of each string must be denoted with an apostrophe, with embedded 
apostrophes denoted by the use of two apostrophes. If the 
strings do not contain spaces, then the apostrophes are not 
required. This mode is very u^-ful when comparing macro parame- 
te> j arguments- In both cases, the strings must be separated with 
a omma. Below are some examples of the use of IFSAriE. 

IFSAME 'test st r i ng * , ' t est string' 

IFSAME R 3HKN| A- D- * * s* , * 2500 A-D- " s r 

IFSAriE *,Y 

In the first example above, the strings contain spaces and 
therefore must be bracketed by apostrophes. The second example 
shows embedded apostrophes, which are represented by using two 
apostrophes- In the third example, a macro might be testing for 
a certain register, and since the strings do not contain spaces, 
they do not need to be enclosed in apostrophes. 



IFDIFF STRIN61 , STRING 2 

This directive is the complement to IFSAME- If the tv-o 
strings are not identical, the statements after this statement 
are assembled up to an ELSE or f ML) I F directive- If the i *o 
strings are identical the statements up to ^n ELSE or ENLiF 
directive are not assembled. Tito syntax rul^s governing the forr« 
of the strings are the same as for IFSAriE* See 1 f SAME fur 
examples of the use of this directive*. 
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IFEXT LABEL 

This directive will cause the Assembler to search the symbol 
table for the label, and assemble the statements following this 
statement up to an ELSE or END IF if the label has been declared 
external- An terror message is generated if the label is not 
found - 



IFttfIXT LADEL 

This directive will cause the Assembler to search the symbol 
table for the label, and assemble the statements following this 
statement up to an ELSE or END IF if the label has not b b*1 
declared external. An error messasge is generated if the label 
is not found. 



IFABS LABEL 

This dir-ctive will cause the Assembler to search the symbol 
table for the label,, and assemble the statements following this 
statement up to an ELSE or END IE if the label is absolute vi.e- 
not relocatable)- External labels are considered to be relocat- 
able. An <*rror message is generated if ihe 1 r-bel is not found., 



IFREL LABEL 

This directive will cause the Assembler to search he symbol 
table for the label, and assemble the statements following this 
statement up to an ELSE or EN! IF if the label is relocatable. 
External labels are considered to be relocatable* An error 
message is output it the label is not found 



IFMA EXP 

This directive is intended to be used inside a macro, end 
will scan the macro call line for the existence of the argument 
number specified by the value of EXP. If the argument exists, 
the statements following this one up to an ELSE or ENDIF will be 
assembled- If the argument does not exist, the statements fol- 
lowing this one up to an ELSE or ENDIF will not be assembled. no 
arguments can be detected by having EXP ~ O. In this case, if po 
arguments are present in the irunero call line, the following 
statements are asse^bl vd 9 and if arguments are present in the 
macro call line, the following statements are not assembled. 
See the Macro section of this manual for examples of the use of 
this directive. 
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IFNKA £XP 

This directive is the complement to IFMA, and checks the 
macro call line to see if the argument number given by the value 
of EXP exists- If the argument is not present, the statements 
following this one up to an ELSE or ENDIF are assembled. If the 
argument is present, the statements following tnis up to an ELSE 
or ENDIF are not assembled. The existence of any arguments at 
all can be detected by having EXP - 0. In this case, if there is 
at least one ^argument in the macro call line, the f ol 1 uwi ig 

tatements will be assembled. If there are no arguments in 
i ncro call line, the following statements will not be assembled. 
See the Macro section of this manual for examples of the use of 
this directive. 



ELSE 

Start of statements to be assembled if any of the above 
type of directives are false. 



ENOC 
END I F 

Specifies the end of a conditional assembly block, when the 
Assembler dett ._ts unmatched IF — ENDIF pairs, an error message is 
output- Since recursive macros will almost always be control led 
by IF type directives, the IFCLEAR directive may be needed. The 
difference between the two is that ENDIF is always executed, 
while IFCLEAR is not executed when it is inside a false condi- 
tional assembly block. 



IFCLEAR 

This directive performs exactly the same function as EriDIF, 
except that it is not executed when it is inside a false condi- 
tional assembly block. This directive can be used in a recursive 
macro to maintain balanced IF ~ ENDIF pairs, allowing the macro 
to eventually terminate, yet still taking advantage of the IF — 
ENDIF checking performed by the Assembler. This directive can be 
used to perform the same function when a macro contains a HACEXIT 
directive for early macro exits, since these would almost always 
be controlled by an IF directive of some sort. See the nacro 
section of this i nual for examples of the use of this directive. 
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ASSEMBLY LISTIN6 CONTROL 
LIST ON 

Turns listing on if directive listing was specified as the 
listing destination when the Assembler was first entered- This 
directive must always used before LIST OFF. In other words, 

at the start of the program, L J ST OIF is assumed. 



LIST OFF 

Turns listing off if directive listing was specified and 
LIST ON was executed. This is the de-fault mode and therefore 
should only be ust-'J following a LIST ON directive. 



MACLIST ON 

Turns lifting of MACRO expansions on- This is the default 

mode. 



MACLIST OFF 

Turns listing of HACRO expansions off „ The default is on. 



CONDLIST ON 

Turns on listing of false conditional assembly blocks. This 
is the de-fault mode. 



CONDLIST OFl 

Turns off listing of false conditional assembly blocks- The 
de-fault is on. 



PASS1 ON 

Turns on the lifting of p**ss 1. This can be used to help 
find errors due to the Assembler fating a different path on Pass 
1 as compared to Pass 2. This condition will usually generate a 
'Symbol value changed btrt^een passes* error* This directive can 
also be useful for finding nested n,.ditional assembly errors. 
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PASS1 OFF 

Turns off lining of pass 1 assuming PASS1 ON was execute". 

PA6E 
EJECT 

Outputs a form feed to the listing device. 

TITLE STRING 
HEADING 

Causes * STRING" to he pr inted at the top of every page. If 
■ STRING* is not specified the * TITLE' directive will be turned 
off. The title may be changed as often as desired and may be 
turned off at any time. The maximum title length is SO charac- 
ters. Also, the first two tabs between the TITLE directive snd 
the start of the string, if they exist, will be ignored. Ail 
spaces and tabs after this will be i* eluded in the title. 

SUBTITLE STRING 

Causes 'STRING* to be printn-d at the top of every page. If 
'TITLE* was executed, the subtitle will appear below it. if 
* 1 TLE* was not «?xe^ uted or was turned off, the subtitle wi lI 
still be output. If 'STRING* is not specified, the directive will 
be turned off- The subtitle may be changed as often as riesir*?c? 
and may be turned off at any time. The maximum subtitle length 
is 80 characters. As with the TITLE directive, the rirst t^*« 
tabs between the SUBTITLE directive and the start of STRING, if 
they exi- t , will be igr ">red and any spaces and tabs that appear 
after that will be incluc ?d in the subtitle. 



PW EXP 

Sets the printer page width. The default page width is 152 
col umns . 



PL EXP 

Sets the printer page length. The default parje length is 6i 
lines. The Assembler issues a form feed when this limit is 
reached or exceeded. If an error is encountered, the Assembler 
will output the form feed after the error message. 

TOP EXP 

This directive controls the number of lines form the top of 
the page to the page number. The default is zero (0) - 
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ASSEMBLY TIME CALCULATIONS 

The following list gives the allowed assembly time calcula- 
tions- Also shown is their priority level- Priority level 7 
operations are the first to be performed. Parenthesis may be 
used to force the calculations to proceed in a different order- 
All calculations can be performed using either 16 or 32 bit 
integer arithmetic with the exception of exponentiation which 
only uses an 8 bit exponent. The type of checks made on Dverflowi 
depends on which mode the Assembler is operating in. See t;ie next 
section for more information on this subject- The maximum number 
of pending operations is 16- Spaces are not allowed in between 
arguments- 



OPERATION PRIORITY 



DESCRIPTION 



Unary +■ 
Unary - 
\ or - NOT 
Unary > 



Unary < 



t 

/ 

- MOD. 
. SHR . 



- SriL ■ 



& or -AND, 
* or -OR- 
. XOR. 



Optionally specifies a positive operano. 
Negates the following expression. 
Complements the following expression. 
Keeps the high order byte of the follow^ 
ing address- This must be used to obtain 
relocatable byte address values. 
\ m ps the low order byte of the follow- 
ing address- This must be used to obtain 
relocatable byte address vaiues- 
Unsigned exponentiation 
Unsigned multiplication 
Unsigned division 
Rernai nder 

Shift the preceeding expression right 
(with fill) the number of times speci- 
fied in the fallowing expression- 
Shift the preceeding expression left 
(with O fill) the number of times speci- 
fied in the following expression. 
Addi t ion 
Subtract i on 
Logical AND 
Logical OR 

Logical exclusive OR 



ASSEMBLY TIME COMPARISONS 

The following list gives the assembly time comparisons which 
will return all 1's if the comparison is true and all O's if the 
comparison is false: 

pM or -HQ. — Equal 

> or -ST. — Greater than 

< or . I T . — Less th«n 

-UGT- — Unsigned greater than 

• LILT. — Unsigned less than 
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16 VERSUS 32 BIT ARITHMETIC 

With the use of the M0D32 directive, the Hssernbi er may be 
directed to perform arithmetic using either 16 or 32 bit arithme- 
tic. The advantage of 32 bit arithmetic is that the chance of 
overflow is greatly reduced- Normally* overflow would only occur 
during an evaluation- In other words, the final result would 
'fit' in 16 bits, but coming up with the result would cause an 
overflow. For example, the following instruction is part of the 
Assembler Source code, and is in a section that is used to auto- 
matically size all the As ambler buffers. The icteft is that if a 
buffer does not meet certain requirements, an error message is to 
be output- This particular example deals with the Symbol T-abie 
buffer, which actually h«s it's own sub- buffer- The main re— 
quirement for the sub— buffer to perform proper iy is \hat it be an 
exact multiple of the main Symbol T«-hle buffer- The fallowing 
instruction will generate an error if thi s condition is not met, 

. IFNZ ( ( SYMLIM— SYMTBL+1 ) - SHL. 16)-( < ( SYMLIM-SYMTBL+ 1 ) /SYMBUFB5 j 
* (SYttBUFBS.SHL. 16) ) 

SYMBOL TABLE BUFFER NOT AN EXACT MULTIPLE OF 5YHBGL TABLE SI ZE. 

. ENDIF 

In this ca^e, the statement in between the IF block is not 
an instruction, and so if the above calculation produ< s a non- 
zero result, the Assembler outputs an error because it Joes not 
recognize the instruction- You also get the statement itself, 
which becomes a 'customized* error message- The item of interest 
here is really the 16 bit left shifts, which are what make this 
technique work in the first place- Now, if the Assembler is 
running in 16 bit mode, these shifts obviously produce a zero 
result. But in 32 bit mode, such is n t the case. What it does 
is essentially maintain a 16 bit remai . ier in ail calculations, 
which happens to be exactly what is needed- So, 32 bit arithme- 
tic can prove to be powerful. 

While 32 bit arithmetic can be a plus, it can produce some 
strange results in two different cases. The first is for those 
users that are us«ed to having Assembly Time Calculators turn over 
without question, such as the following example. 

SI ZE: . EQUAL 1 3 0OH-CB0OH 

In this case, underflow actually ex i s s, but it is probably 
an address calculation and it does not matter. For cases such 3S 
this, the 16 and 32 bit mode will pr wide two different results. 
The 32 bit mode will produce an error message indicating that the 
result is too large to fit in a 16 bit register, while the 16 bit 
mode will process this expression with no problem- The reason 
for this is that the 16 bit ■-■*? drtf-s ot chock for overflows, 
and the result therefore will always te at most a io bit result. 
On the other hand, the 32 bit mode is able to detect that the 
result is actually too large. 
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Another important item to keep in mind is that all values 
stored in the Symbol Table are 16 bit values. There-fore, when m 
symbol is involved in a calculation, it enters the calculation as 
a 16 bit number- Consider the following example where this 
creates a condition that appears to the Assembler to be a result 
that is larger than 16 bits, but there doesn't appear to be any 
reason for it. 



FALSE: 
TRUE: 



. EQUAL 
. EQUAL 





.NOT. FALSE 



; Define rnL^t 
; Define TRUE 



- IFNZ 
-END1F 



.NOT. FALSE 
A,RO 



. IFNZ 

MOV 

. END IF 



-NOT- TRUE 
A,R1 



What happens here is the Assembler outputs a '# TOG LAf*6E r 
error for the -NOT -TRUE ex prer si on - This happens because TRUE 
was stored in the Symbol Ta* le as FFFFH. The Assembly Time 
Calculator does not sign extend it, because it really doesn't 
know whether it is even a signed number or not- But when it 
takes the 32 bit ones complement, the result is FFFFOOOOH. W,-xt 
the routine that was originally called by the IFNZ directive 
knows that it is to ch^ck for 16 bit results, and determines that 
the result will not fit in a 16 bit register- This would not 
occur if TRUE was generated in the expression- it is the fact 
that TRUE was passed in as a 16 bit value that causes the 
problem. 



In summary, it is recommended that 32 bit arithmetic be u^ed 

only for those cast s where overflow is undesirable during the 

calculation, and th< n the Assembler should be put back into the 
16 bit mode- 
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HACROS 

DEFINITION 

A macro is a sequt. .r.e of source 1 i nes that will be substi- 
tuted for a single source line. A macro must be defined before 
it is U5^d. The Assembler will store the macro definition and, 
upon encountering the macro name, will substitute the previously 
defined source lines. Arguments may be incino»-d in the m^cro 
definition. 

For macro definitions, dummy arguments may not contain 
spaces. However, for actual macro calls, arguments may he any 
type; direct, indirect, character string or register. Spaces 
e na x allowed in arguments unless it is an Asci i string, in 
which case the string must be bracketed in apostrophes. If the 
string contains an apostrophe, this can be sp^ci-f i ed with two 
apostrophes in a row. Arguments will be passed through to *ny 
nested macros if the dummy argument names are identical* Macro 
nesting is limited only by the amount of disk space available. 

To define a macro the " - MACRO" directive is used. A macro 
must have the " . MACUND" or " . ENDM" directive following the m^cr o 
definition. The name of the macro is in the label field. 



ARGUHUKT SEPARATORS 

In the macro call line ft) guments must be separated by co?rs— 
mas, however leading spaces and tabs are ingnored. If no argu- 
ment is present, a single comma will serve as a place holder. In 
a macro body, the following argument separators ar? allowed: 

, + -*/** \ &~ = <><>lj; 

-NOT. . AND. .OR. - XOR. - £Q. . GT. . I T. . UGT. 

-LILT. . SHR. . SHL - 



CONCATENATION 

The broken bar character (! - hex 7C) is used as the string 
concatenation operator. Concatenation .nay only be performed 
inside of a macro. 
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MACRO EXAMPLES 

The first example simply uses a macro to 
instruction that is not part of the standard 8748 
set . 



aetine 
i nstr uc t i on 



CLRRO: 



, MACRO 
MOV 

- MACEND 



P0,0 



This macro 
Assemb 1 er f i nds 
body -for it, i.e 



clears fcfre register R0, 
this instru- tirn, it will 
MOV : 0,0. 



ana every 
subst i tut e 



rime ^ne 
the nacrq 



Suppose instead of always clearing r. gister RO T it is 
desired to clear any particular register- In this case, the 
string replacement -facilities that macros provide can be used. 
Consider the -fallowing example. 



CLEAR; 



. MACRO ARG1 
HQS! f <G1 , 

. MACEND 



In this case, whenever the Assembler -finds the instruct i c?r» 
CLEAR in the mnemonic field, it will substitute the first 
argument in the operand field for the so cal 1 ea Dummy Parameter 
ARG1. To clear register R2 for example, tt e -following ource 
line would be used. 



CLEAR 



R2 



Here the Macro Processor would replace ARGi with R2 
then pass this instruction to the Line Parser, which 
assemble i t as MOV R2.C- 



wot u o 



This macro can be modified to have it clear either ^ 
register or a memory location by making use of »~onditionai 
assembly directives. This could be done as follows. 



- MACRO 


ARG1 






. IFSAME 


A, AR61 


; Regi ster 


H ? 


CLR 


A 






- ELSE 








. IFSAME 


RO, ARG1 


; Regi ster 


RO ? 


MOV 


RO,0 


; CI ear it 


i f so 


-t SE 








. IFSAME 


Rl, AR61 


; Regi ster 


Ri ? 


MOV 


R1,0 


; CI ear it 


i f so 


. ELSE 








MOV 


PO,ARGl 


; Gtherwi m 


i clear the 


MOV 


SR0 s 


; memory 


1 ocati on 


. END IF 








-END IF 








- END I F 








. MACEND 
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NESTED MACROS 

Macros may be nested to any desired level, limited only ay 
the size of the disk storage device- For the following example, 
assume that a macro that will clear the CPU registers A, RO and 
fil is wanted. This can be done by making use of CLEAR, the 
macro us*ed far the above example. 

CLR^REGSs - MACRO 

CLEAR A 
CLEAR RO 
CLEAR R 1 

. MACEND 

The Assembler would generate the following source cede in 
place of this macro. 

CLR A 
MOV R0,0 
MOV R1,0 



Another way to write this macro is with multiple parameters, 
along with a check for which parameters are actually present 
using the IFMA directive. 



CLEAR: 



- MACRO 

- IFMA 
I JV 

. ENDIF 
. IFMA 
MOV 
.ENDIF 
, IFMA 
MOV 

, ENDIF 
- MACEND 



ARG1 s ARG2, AR63 

1 ; 1st argument present ? 

AR01.O ; CI ear it if so 



2 

ARS2,0 

3 

ARG3,0 



; 2nd argument present f 
; CI ear it if s- 

; 3rd argument present ? 
; CI ear it if so 



This macro could be called using any combination or 
registers as shown below. 



CLf£AR 
CLEAR 
CLEAR 
CLEAR 



A 

A,RO 
RO 

A, RO,Rl 



; CI ear register h 
; CI ^ar registers A Sc RO 
; C 1 ear r eg i ster RO on I y 
: CI ear all three 
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LABELS IN MACROS 

Labels are allowed in macro definitions. Labels may be 
de-fined in two ways: explicit or implicit. Explicit labels in 
the macro definition will not be altered by the Assembler. 
Implicit labels are followed by g * y . The Assembler will 
substitute a 3 digit macro expansion .lumber for the In this 

case, the label and the macro expansion number must not exceed iu 
characters. A label that ends with a "#" symbol outside or i 
macro will receive the same expansion number as the last macro. 
This provides for renaming labels without having to know the 
actual macro expansion number. An argunent may not be used to 
specify a label. If this is required, the argument may be equat- 
ed to a label inside the macro- If the argument is a parameter 
that will be be changed insi-le the m. cro, it can be equated tc s 
variable using the * VAR* directive. See the section entitl *d 
Recursion for an example of this. 



MNEMONIC REDEFINITION 

The Assembler tables are searched in the foil owing 

or d er : 



1st — Assembler Directive Table 
7 d - Macro Definition Table 
Id- 87 48 Mnemonic Table 



Therefore, S74S mnemonics may be redefined using macros 
and Assp-Tibler Directives may be added but not redefined, as long 
no decimal point preceeds them. This is due to the fact that 
any mnemonic field starting with a decimal point is automatically 
assumed to be a built in Assembler Directive. 



■ 
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RECURSION 



When macros are nested, all the information required to 
return to the previous source code environment is saved on disk. 
This design is what enablf ^ the Assembler to store macros on di«=k 
and still allow nesting to any desired level- Recursion (a macro 
calling itself) is allowed and is achieved by detecting that the 
macro is already active, and inhibiting the writing of the pre- 
vious source code environment- However, a macro may not c?.1 1 
another macro that in tur n c^lls the first macro. When this 
occurs, the original r *.urn information is destroyed «nd the 
Assembler will not be able to rfturn to the previous environment* 
Furthermore, the Assembler is nut ^ble to detect this condition 
because when the second macro activates the first macro, which is 
already active, the Assembler assumes a recursive macro con ; i- 
tion, and does not record the information needed to return to the 
second m, cro. 



Below is an example of a recursive macro that reserves the 
number of data bytes defined by dummy argument ARG1 and fills 
them with the value specified by ARG2. 



RESERVE 
COUNT: 



COUNT: 



. VAR 
. IFZ 

- IFCLEAR 
.MACEX IT 
■ENDIF 
. VAR 
- BYTE 
RESERVE 
- MACEND 



ARB 1 , ARG2 

ARG1 

COUNT 



COU r-i 

ARG2 

COUNT, ARG2 



; Store # of bytes to S »v< 
; Check for done 
; CI ear the pending IF 
; And q^t nut 

;Else dec byte count 
; Reserve the by* e 
; Loop through again 



This macro would be called with a statement such as the 
foil owi ng : 

RESERVE 10,55H ; Reserve iu bytes e.rrd 

store 55 hex in each one 

It is perfectly legal for a recursive macro, such as the one 

in the above example, to call another recursive macro and =o 
forth out to whatever level is desired. 
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ASSEMBLER ERROR HESSA6ES 



PROGRAMMING ERRORS 

This section provides a list of the error messages output by 
the Assembler for reference along with a possible reason for the 
error message and an example of code that might: produce the 
<?rror. Wie reason it's not more definite is that some errors 
have a dependency on previous events. 



Error - SYNTAX ERROR 

Meaning — Usually a missing cornea or parenthesis. 

Example - hOV A,RO) ; Missing left parenthesis 

Error - CAN'T RESOLVE OPERAND 

Meaning — Can't tell what the programmer intended. 

Example - MOV B, 12H ; B i^n ? t an 8748 regist r 



Error - ILLEGAL ADDRESSING MODE 

Meaning - C<%n ' t address the operand using this form. 
Example - RR 3R0 ; Register Indirect 



ill egal 



Error 
Meani ng 
Ex amp 1 e 

Errar 
Meani ng 
Ex amp 1 e 



ILLE6AL AR6UHENT 
Operand can't be 
C1_R RO 



used 



here, 

; Onl y 



A is legal 



MULTIPLY DEFINED SYMBOL 

Symbol defined previously (not inlcuding 
LABEL: NOP ; 1st definition 

LABEL: MOP ; 2nd definition 



vmr I 



Error - ILLEGAL MNEMONIC 

Meaning - Mnemonic doesn't exist and wasn't defined as a riacro. 
Example - TEST RO ; There is no TEST instruction 



Error - # TOO LAR6E 

Meaning - The destination is too small for the operand. 
Fx ^ pie - MQV A,123H ; 123H won t fit in a bits 

Note - This may occur when the Assembler is operating in 3^ 
bit arithmetic mode, even though the operand appears to 
be the correct size. This is due to the fact th^t 
although all internal operations are performed using 32 
bit arithmetic, the result i s at most io bits. There- 
fore, when a previous result is involved in the calcu- 
lation, it is only a 16 bit number. See the "HGI»32 r 
directive for a further discussion of this subject. 
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Error - HEX # AND SYMBOL ARE IDENTICAL 

Meaning — A label G , i sts that is exactly identical to a hex 
number that is being used as an operand- Even the hey, 
number indicator must be in the same place -for this 
error to be generated. 
Example - ABH: NOP ; Define label 

MOV A, ABH ; Assembler can't tell bet v -en 

; label and legal hex number. 



Error - UNDEFINED SYH&OL 

Meaning - Symbol wasn't defined during pass 1 - 
Example - LABEL: NOP ; Label defined 

JNP LABLE ; Typo makes it unrecogni. ubie 



Error - RELATIVE JUHP TOO LARGE 

Meaning - Destination addr i s in a different page. 
Example - LABEL: . BLK'B 130 ; S m-rate distance 

NEXT: JZ LABEL ; L BEL in a different page 

Note — , In an assembly that contains a large number of errors, 

this error should be inspected last because the program 

counter becomes out of sync. 



Error - ILLEGAL ASCII DESIGNATOR 

Manning - Bad punctuation on Asci i 
Example - MOV A„ " T ' 



character . 

; Must be enclosed by the s^nre 
; type, either " or y . 



Error - END OF 0. ERAND EXPECTED BUT NOT FOUND 

Meaning - Usually a syntax or format error. 

Note — This error is the last check on any instruction before 
the Assembler proceeds to the f**xt line and indicates 
that there are extra characters after a legal operand 
termi nator . 



Error - ATTEMPTED DIVISION BY ZERO 
Meaning - Divisor operand evaluated to O. 
Example - DATA: -EQUAL 1 0/ <S- (2**3) ) 

Error - TITLE /SUB TITLE EXCEEDS BO CHARACTERS 

Meaning — Buffers are sized for 80 byte titles and subtitles. 
Example - . TITLE * (Gl bytes later) ... 



Error - SYMBOL VALUE CHANGED BETWEEN PASSES 

Meaning — Symbol value decode during pass 1 not — pass 2 . 

Example - LABEL: .EQUAL LABEL2 ; LABLE2 not defined yet 

; (not including r -vAR r > 

Note - This error is usually caused by the Assembler taking 

different paths < >n Pass 1 as compared to Pass 2 due to 
conditional directive arguments changing value. The 
directive PASS1 ON /OFF can bfi useful in finding 
these types of errors. 



>2 
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Er r or 
Meani ng 
E>:dmp] e 



Not. 



NESTED CONDITIONAL ASSEMBLY UNBALANCE DETECTED 

Any ? .IF' type instruction without a matching *.ENDIF r 
- IFNZ 1 ; 1st iF 

, IFNZ 1 ; 2nd IF 

NOP ; intermediate code 

• END I F ; only 1 END IF 

See the Assembler Dir ecti ve section -for the use of the 

* . IFCLEAR* directive. 



Error - ILLEGAL EXTERNAL SYMBOL 

Meaning - External r^nrence can ? t be used herp. 

Example - -EXTERNAL LABEL ; External declaration 

JZ LABEL ; Relatives can't be ext. 

Error - PARAf- .TERS EXCEED 80 CHARACTER 

Meaning — The maximum Macro parameter length is 80 characters. 
Example - TEST: - MACRO ARG 1 , ARG2 (80 chars later; . - ArC-trO 



Error - NESTED MACRO UNBALANCE DETECTED 

Meaning — Extra _ ENDM -found during m^cro expansion. 

Example ~ MACROl ; U^e macro 

. ENDM ; There is already i . ENE*r» 

: in the macro rfe-finition. 
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SYSTEM ERRORS 

The following errors are not really programming error:, hut 
are detected by the Assembler and in some cases can help explain 
unexpected results, especially when used in conjunction with the 
PASS1 directive. 

Error - MISSING END STATEMENT 

Meaning — No -END -Found at end of file or end of included moriui*. 



Error - CAN'T FIND INCLUDE FILE 

Meaning — Filename incorrect, search started from 
drive number, .DRIVE directive should be 
just simply a non-existent file. 



1 □ high 
ex ecuted 



a 



Error - ILLEGAL NESTED INCLUDE 

Meaning - One included f i 1 * containing an 
This error may also indicate that 
not have an END statement - 



. j iMijcuuti ai receive, 
an included file did 



Error - NOT ENOUGH PAR AMI TERS 

Meaning - 1 he Assembler wa- initiated with a command line wi thnut 
sufficient information- Especially check for x istir!*g 
destination and responses to the „ ASK directive. 



Error - OPEN FILE EKROR 

Meaning — The Assembler cannot open the file 
non-existent file. 



usually oenotps = 



Error - CREATE NEW FILE ERROR 

Meaning - The Assemhler is not able to create the output file. 

This usually is due to a full disk. Note that because 
the Assembler creates 6 files, even for small programs 
this might occur. Also, when detected, the Assembler 
deletes all the files it has created up to that point, 
and so the disk may appear to have room. There must be 
at least 6 times the smallest allocated block size 
avai 1 abl e. 



Error - WRITE ERROR 

Meaning - The most likely 
NEW FILE ERROR. 



cause is a full disk. bee also LKtH't 



Error - CLOSE FILE ERROR 

Meaning - Tl i s error indicates that the Assembler cannot close 
out one of the 6 files it creates, usually because of 
insufficient disk spare or directory space. See also 
CREATE NEW FILE ERROR. 



Error - RANDOM RECORD READ EFfc 
Meaning - This is the type < f 
illegal operations 
such as when two mac 



» i or th^t will be directed when 
nvolve data stored on the disk, 
oss are calling each other. 



J- 4 



2SOO A«, D. 87AS CROSS ASSEMBLER LINKER - VERSION 3.00 



250O A.D. 8748 CRU3S ASSEMBLER LINKER 

The 2500 A. D - Linker allows the user to write assembly 
language programs consisting of several modules- The Linker 

will resolve external references and perform address relocation 
for up to 12S files, with the only limit to the number of Global 
symbols, External symbols and the object code size being the 
amount of disk storage space available- The Linker will operate 
in either Prompt mode or Submit mode as described in the 'Linker 
Operating Instructions' action of this manual. 

To match different output requirements, multiple versions 
of the Linker are provided- Theve different versions, identified 
by the names that they are shippi.-d with, are described below. 

L INK 1 - Executable File Output 

The Linker shipped with the name LINK! should be used when 
the desired output i s an executable object code file- This means 
that the code will be linked and relocated to the desired ex ecu - * 
tion address nnd any gaps resulting from Origin directives will 
be filled in with zeroed bytes- Only Origin directives with 
ascending address values will be handled correctly, This is 
because of the origin gap filling that is required to obtain an 
executable fil<?- Origin directives in descending order will 
probably gener* e ^n output file much larger than expected due no 
huge gaps being filled in- If Origin directives are in descend- 
ing order and/or if Origin gaps are not to be filled in, LiNKi 
must not be used- The default output extension of LINK! is 
* TSK*, chosen to imply an executable file, but not one that is 
executable on the host system. 

LINK2 - Intel Hex File Output 

The Linker shipped with the name LINK2 should be used when 
the desired output is an Intel Hex format file. This Linker will 
relocate and link all the input modules, but gaps rt suiting from 
Origin directives will not be filled in. Instead, a new Intel 
Hex r&eord will be started- Therefore. Origin statements may be 
in descending order- The output file is not sorted in ascending 
address order, but appears exactly as the load map shows. The 
default output extension of LINK2 is * HEX' - 
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LINKER OPERATINB INSTRUCTIONS 

In the descriptions which follow, it is assumed that the 
user has renamed the appropriate Linker to LINK. EXE for riSDGS 
and LINK.CMD for CPM 86. 

PROMPT MODE 

To run the Linker type*: LINK 

The program will respund with: INPUT FILENAME : 

The user may enter a filename and an extension, or if just 
the filename is entered, the Linker will assume the extension is 
'-OBJ* since this is the default output extension from the 2!5uO 
A.D, Assembler, 

Aft *r the user enters the filename, the program wi I i ask 
for the Load Address- All addresses within the file will be 
relocated to this address. Tt is expected that the Load Address 
for the first file will be specified, but after that the user 
will normally want the files to start where the previous one ie-ft 
off, in other words 'stacked'. To r -i ^rk files, just type a 
carriage return in response to the Load Address prompt. 

For those cases where a file contains Global symbol values 
that another program needs, but the actual object code from that 
file is not needed (such as overlays) respond to the Load Address 
prompt with a minus sign (— ) before the address- The Linker will 
use the Global symbol values but the object code from that file 
will not be included in the Linker catput file- This type of 
file is referred to as a 'Reference Only* file, and appears that 
way in the Load Map. The Reference Only file will be completely 
relocated and linked, which means that the Linker can stack 
Reference Only type files- This is done by entering the 
which signifies reference only, followed by a carriage return, 
which tells the Linker to stack the file on top of the previous 
file- See the section entitled * Linker Examples 1 " for examples of 
the use of this feature. 

The Linker will continue to accept filenames and i oad 
addresses until the user types a carriage return in response 
to the FILENAME prompt- The filenames should be entered in the 
order in which they will be loaded into memory for execution. 

After all input filenames have been entered, the Linker will 
prompt the user for the output filename. A carriage return only 
response will cause the Linker *o ncne the output file with the 
same name as the first input file, but with an extension deter — 
mined by the Lin' er being used- See the section t-ititied 'Linker 
Description' for the different Linker^ default output extensions- 



■ 
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SUBMIT MODE 

When linking a large number of files, the Prompt mode is 
error prone. In this case the input to the Linker can be taken 
from a file. The file input to the Linker would contain ail the 
answers to the prompts, just as though the Linker was being run 
in Prompt mode. The underbar < ) character may be used to create 
a 'carriage return only' type response in a file, resulting in a 
response that can be inspected by the user. 

Below is an example of a file that would be used to run the 
Linker in Submit mode. 



Input Filename 
Load address 
Input Filename 

Load address (or optional 7 _ y if stacking) 



Last Filename 

Last address (or optional * _' for stacking) 
At least 1 space or *_* for nc more f U > na jnog 

Output Filename (or optional * f <r default followed by a <CR>> 



Assuming 'he Linker prompt file was named LINK, DAT, the 
Linker would bt in with the following command: 

LINK LINK, DAT 



This command could either be issurd from the console or 
included in a Batch file- Note that the carriage return after 
the Output Filename response is required- 
Input filenames have the default extension o-f .OBJ , since 
this is the default output extension of the 25O0 A.D. Assembler. 

If a carriage return only response is used for the output 
filename, the Linker will use the first input filename along with 
the appropriate extension for the Linker being used as the output 
f i ] e-n-M.e. These extensions are described in the section entitled 
'Linker Description'. 
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LINKER OPERATION 

This section describes some of the operations performed by 
the Linker- For a description of the different Linrer operating 
modes see the section entitled 'Linker Examples'. 

ASSEMBLY ORIGIN HANDLIN8 

Normally, a program that Mas to be relocated would not have 
an .ORIGIN directive, and therefore would be assembled starting 
at address 0000- The Linker would then add the load address 
specified by the operator to t he address calculated by the 
Assembler to obtain the relocated address. However, the original 
assembly address does not h, ve to be O. Therefore, if the program 
was assembled at an address other than 0000, the result that car 
be expected is the assembly address plus the load offset address. 
The Load Map g^ierated by the Linker always shows the value 
the program has been linked and relocated to run at. Care must 
be exercised when stacking modules with other modules that 
use of descending Origin statements- In this case , the user !5U«rfe 
insure that the Linker has a definite address on which to st »cit 
the modules. This can be acrompl ishnd by using absolute Ic^d 
addresses for the modules that have descending Origins and then 
stacking only those modules that have ascending addresses. ■_ IN*, i 
can never be used for files that have descending Origins. 

CODE * DATA ADDRESS SPECIFICATIONS 

Code and Data addresses are specified as Cc*de tirst folio^-ed 
by Data, with a comma separating the two, If no Data address is 
specified, then all Data sections will be relocated and sc^c^ed 
on top f the Code sections. The Code address may be skipped by 
the use of just a comma. If no Code address is specified but i 
Data address is, all the Code sections will be relocated and 
stacked on top of the Data sections. Code and Data may be 
processed independently by explicitly responding to the Load 
Address prompt for each section. 

GLOBAL - EXTERNAL SYHBOLS 

The Linker matches external symbols <if any) with global (or 
public) symbols. If multiple global symbols are encountered, an 
error message is output. The lead offset value is added to the 
assembly value of the global symbol before using it as an 
operand* If the external symbol is * 4 or S bit value, and the 
global symbol is too large an error message is output with the 
symbol name, the name of the file the symbol was declared GLuBmL 
in and the name of the file the symbol was declared EXTERNAL in. 
If an external symbol has no matching global symbol, an error 
message is output along with the name of the file that the symbol 
was declared EXTERNAL in. 
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ADDRESS RELOCATION 

Addresses are relocated by adding the load address to the 
offset decoded by the 2500 A.D. Assembler- Normally the program 
would be assembled starting at location OOOO, but it doesn't 
have to be. The load address will simply be added to any address 
genernted by the Assembler. 

The Assembler maintains a table of attributes associate 
with each symbol used in the program. If the label simply pre— 
ceeds an instruction, then it is tagged as relocatable. If the 
label is defined in an ".EQUAL" directive, then the r el ocat ab? 1 - 
ity of it depends on the operand field type. If the operand 
contains no relocatable tokens, then the expression is not relo- 
catable. If the operand contains only one relocatable token, 
then the expression is relocatable. If the operand contains tv^o 
or more relocatable tokens, then the expression is not relocat- 
afc 1 e . 

Byte values are only relocatable candidates if the ur^r y 
greater than * >' sign is used for the high byte and/or the unary 
less than *<' sign is <;*ed for the low byte. These operands srg 
subject to the same relocation rules as full 16 bit address 
val ues. 

Following are BQ mm examples illustrating these points. 



LABEL 1 . I JP 



; The label is defined to be equal 
; to the address of an instruction 
; and therefore is relocatable. 



LABEL2: . EQUAL LABEL 1 ; The label is defined to equal ^ 

; value that w, 3 tagged a 3 rt?io- 
; eatable- Therefore, LABEL2 is 
; also relocatable. 



LABEL 3 ; . EGUAL IO ; The i abel is defined to eqi-*i =i 

; < ansiant. Therefore, LABEL3 is 
i not relocatable. 



LABEL4: .EQUAL $+10 ; The label is defined to equal a 

; relocatable value pi us a non— 
; relocatable value. Since only 
; one value is reiocaranie, the 
; symbol LABEL 4 is relocatable. 



LABEL5: . EQUAL 10+* ; The label is defined to equ?! = 

; tion-relocatable value plus a re— 
; 1 oca table value. Since only one 
; value is relocatable, LA BEL 5 is 
; relocatable. 
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L ABEL6 ; « EQUAL LABEL5— LABEL2 

; The label is de-Fined to equal 3 
; relocatable value minus another 
; relocatable value, producing 3 
; non-relocatable result. 



The last example is worth remembering when using the As«e™- 
bier to do things such as calculate data sizes. Consider the 
fid! lowing example of a table of dnta values, with the number or 
bytes b^ing calculated automatically at assembly time by trie 
Assembler, allowing the programmer to acid or delete from the 
table without having to remember to change the data block size. 



DATA: 



BYTE 
WORD 
BYTE 
BLKB 





10 

20 

5 



DATA SIZE: 



- EQUAL 



DATA 



The Assemble 
because the resul t 
the data block size 



will calculate the 
is not relocatable, 



ze of che data bi or k, and 
the Linter will not alter 
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LINKER EXAMPLES 

his section consists of examples intended to demonstrate 
the use of the Linker. The Linker prompts wi i i be shown in '-^pper 
case, and the user responses will be shown in lower case- The 
<cr> symbol denotes a carriage return and is shown only when no 
other response to a prompt is desired- Otherwise, all inputs are 
assumed to be terminated with a carriage return. Also, for the 
purpose of these examples, forrjet about the fact that filenames 
must be limited to 8 characters. 



Singl« File A$se«bUd At D«sirL*d Run Addrts« 

The first example is the case of just one file which has 
been assembled error free a, the desired run address by th» use 
of the ORIGIN directive- Cince only the Code section address is 
input, if the file contains Data sections they will be stri.*i:ed on 
top of all the Code sections,. 



INPUT FILENAME : filename LOAO ADDRESS (OFFSET) : 

INPUT FILENAME : <cr> 

OUTPUT FILENAME : <cr> 



The above will cause the Linker to read a file by the 
of * FILENAME. OBJ 7 5 add to all Code section relocation 
addresses, add the total size of all the Code sections to ail 
Data section relocation addresses, and output a file with tne 
same name as the input filename and a default extension ^s 
described in the section entitled 'Linker Description'. 

If the Data section load address is specified but the Code 

section load address is omitted, then 11 the Code sections will 

be stacked on top of the Data section* - This is specified « 
shown below. 



INPUT FILENAME : filename LOAD i 3DRESS i OFF SET i ; , 

INPUT FILENAME : <cr> 

OUTPUT FILENAME : <cr> 



If both the Code and D-^ta sections were assembled at the 

desired address by the uMfefg of the ORIGIN directive, thpn an 

offset of O must be specified for b^th sections as shown belo*-. 

INPUT FILENAME : filename LOAD ADDRESS (OFFSET) : G,0 
INPUT FILENAME : <cr> 



OUTPUT FILENAME : <cr> 
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Single File AssenbUd At OOOO 

The following example is trie same as the above example 

except that the program either did not contain an ORIGIN 

directive or the value or the ORIGIN operand was OOOO. 



INPUT FILEN ME s filename I DAD ADDRESS (OFFSET) ; i GO 

INPUT FILENAME : <cr> 

OUTPUT FILENAME : <cr> 



This would cause the Linker to read a file by the na™*» of 
FILENAME. OBJ, relocate all . elocitdble Code section values to 
OlOO Hex H achieved by adding 10O Hex to each address offset 
generated by the Assembler, and then relocate all relocatable 
Data section values by adding 100 Hex plus the total size of the 
Code sections tn them . The result is the Data sections stacked 
on top of the Code sections- The output would be a file with the 
same name a*; the input file and with an extension which depends 
on the I inker used- The possible ext* ;sions are described in the 
section entitled 'Linker Description' . 



The following example is the same as the above ey.=,Tpl9 
except that the Data sections would be relocated first, and the 
Code section* would be stacked on top of all the Data sections. 



INPUT FILENAME : filename LOAD ADDRESS (OFFSET) : , IGO 

INPUT FILENAME : <cr> 

OUTPUT FILENAME : <cr> 



The example below shows the case where both the Code 
sections and Data secti ;ns have been given addresses to be 
relocated to. 



INPUT FILENAME : *il«ttaJ*e LOAD ADDRESS < OFFSET > s 100, 2w 

INPUT FILENAME : <cr> 

OUTPUT FILENAME : <cr > 



Note th^t if the Code sections extend beyond the uats 
sections starting address, LINK1 cannot handle this situation 
because it is impossible to generate an executable object fil 9 
since both Code and Data are residing at the same address. The 
resulting file will more than likely grow larger than S4'*<~. ^s 
LINKi attempts to fill in the gap, at which time an error mess^ye 
advising the user of this situation will be output. 
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Two Files Assembled at Run Address, Stacked 

This example consists o-f two files that have been assembled 
error free at the desired run address, each one containing re^r- 
ences to the other- The first file contains the entry point to 
the program* Nhat is desired is to link the two files teg ether 
just as if they had been asSMibled as one file, with the Cone 
sections being relocated and stacked on top of each other fir^t, 
followed by the Data sections being relocated and stacked on top 
of all the Code sections. 



INPUT FILENAME : filenamel LOAD ADDRESS (OFFSET; : 

INPUT FILEIMAME : filename LOAD ADDRESS < OFFSET) : <cr; 

INPUT FILi£NAME : <cr > 

OUTPUT FILENAME : <cr> 



In this case, the Linker would read a file by the name of 
FILENAME1 - OBJ 9 calculate the size of the object code and add the 
value to the initial OR 1(5 IN value. Then the Linker would resd 
a file by the name of FILENAME2. 03J and *dd the value O + the 
initial ORIGIN value in F ILENAMEl - OBJ * the size of the object 
code in F I LENAME 1 • OBJ . Note that this will only produce stacked 
code if FILENAME2 does not have an ORIGIN statement in it, or if 
it does, that it's value is 0. The output fr >m the Linker would 
1 a a file with the same name as the first ir ui filename, but 
with an extension as determined by the Linker used. See the 
section enttitlcd 'Linker Description* for the extensions output 
by the different Linkers. 



The following example is the same as the above example 
except that the Data sections are to be stacked on top of each 
other first, then all the Code sections are to be stacked on top 
of the entire Data section. 



INPUT FILENAME : filenamel I. DAD ADDRESS foFFStT) : ,0 

INPUT FILENAME : filename2 LOAD ADDRESS (OFFSET) ; <cr> 

INPUT FILENAME ; <cr> 

OUTPUT FILENAME z <cr> 



In the following ex.^ple both the Code and Data starting 

addresses are specified, and Code is stacked on Code and Data is 
stacked on Data. 

INPUT FILENAME : filenamel LOAD ADDRESS \OFr5-T) : i GO , 500 

INPUT FILENAME : filename^ LOAD ADDRESS (OFFSET) : <cr> 
I NPl T F I LFNAME : < c r > 

OUTPUT FILENAME = <cr> 
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Two Fil«s ABsenbUd At OOOO, Stacked 

This example consists of two -files that are to be linked 
together into one file. They may or may not reference each 
other- Both files were assembled at location 0, and there-ore 
must be relocated to the desired run address. 



INPUT FILENAME : filenarnel LOAD ADDRESS (OFFSET) : iOO 

INPUT Fit EMAHE : filename2 LOAD ADDRESS (OFFSET) : <cr >, 

INPUT FILENAME : <cr> 

OUTPUT FILENAME : <cr> 



The Linker will read and relocate the object code from thm 
file FILENAME! - OBJ , then read and relocate the object code from 
the second file F ILFNAME2,. OBJ and relocate i t so that it star ^-e 
after the last byte of the object code from F I LENAME 1 . OBJ . Any 
references to the oth^r file will be resolved during this 
process. The result will be une file with all addresses relo- 
cated to run at OlOO M*?x 9 with all Code sections first, foil c^ed 
by any Data sections. 



Single File ^th Multiple Origin Statements 

This example considers the case where a file contains *or« 
than one OR1QIN directive. The load address will be added to 
whatever value was specified in the source file, 



INPUT FILENAME ? : filename LOAD ADDRESS (OFFSET) ? : IOO 

INPUT FILENAME 7 ; <cr> 

OUTPUT F 1 LENAME ? : <cr> 



The Linker will read a file by the name of FILEivAhE- G£J and 
begin adding IOO Hex to the relocatable addresses. When it 
detects that an ORIGJN statement was executed the action tai:t?n by 
the Linker depends on the Linker being used. If LINK1 is being 
used it will check for an Origin gap. If there is one, it will 
fill it with zeroed bytes, since this is required to generate an 
executable object file- Therefore, if the Origins are in 
descending order, LINK1 cannot correctly gener «te an executable 
file since it will fill the gap by rolling over past FFFF Hex to 
0000 Hex. This will more than lil-ely produce a file larger than 
£>4K and the Linker will output an error message advising the user 
of this condition- Versions of the Linker that do not fill in 
the Origin gaps. such as LINK2 which outputs an Intel Hex file, 
can be used with descending Origins. 
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Two Files, On* Used Only For Global Values 

This example illustrates the concept ot neterence Only 
-files. Assume the first file contains object code assembled at 
and also contains external references to say, a jump table of 
system routines. The jump table already exists and is not to be 
made part of the program- It is simply the jump Rddres^es th^c 
are neeeded. Assume the jump table resides at address A00O Ht>x . 



INPUT FILENAME : fU enamel LOAD ADDRESS (OFFSET) : 100 

INPUT FILENAME : filenan.e2 LOAD ADDRESS (OFFSET) : -AO00 

INPUT FILENAME : <cr> 

OUTPUT FILENAME : <cr> 



The Linker would read a file called F ILENAHE i - OBJ and link 
all extenal references to a file called FILENAME2- OBJ - Before 
the addresses from F ILENArU£2 . OBJ were used, hOOO Hex would be 
added to them, therefore that file would probably have been 
assembled at 0. If nat„ th*-n the desired result could have been 
obtained by entering -O for the OFFSET for FILENAME2- OBJ . The 
output file would cc.isist of the object code from F I LENAi «£ 1 . Orr J 
with all references to FILE. NAME 2. OBJ rosolved, but no object code 
from F ILENAME2. OBJ would be included- Note that the first file 
should contain the program entry point (assumed equal to the 
first ORIGIN statement operand if no entry point is specified 
after the END directive, or assumed to be a relocatable OOOO if 
no ORIGIN directive was executed) and there-fore the Reference 
Only file was specified after the main object code file- 
In the above example, the Data sections followed the s^r?*e 
attributes as the Code sections, i.e. if the Code section was 
Reference Only, so was the Data section- Both Code and Data 
sections may be specified independently, so that Code may be 
Reference Only, but not Data, or Data may be Reference Only, but 
not Code. 
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Three Fil >s f Two Stacked lc Used Only For Blobal Values 

This examp 1 e is similar to the above example with the 
ai 1 i t i on of another Reference Only file which is to be stacked on 
top of the first Reference Only file. 



INPUT 
INPUT 
INPUT 
INPUT 



FILENAME 
FILENAME 
FILENAME 
FILENAME 



fil enamel 
f i 1 pnani >2 
f i 1 f-n^-f; ■ '3 
< cr > 



LOAD ADDRESS 
LOAD ADDRESS 
LOAD ADDRESS 



(OFFSET) 
(OFFSET) 

(OFFSET) 



1UU 

-AO00 
— <cr > 



OUTPUT FILENAME : <cr> 



This example illustrates the ability of the Linker to stack 
Reference Only files. The Linker will read a file with the name 
of FILENAME! - OBJ . relocate it by adding 100 Hex to ail reioc-ble 
values and then resolve external references to FILENAME2 . DBJ and 
FILENAME3. OBJ , Before any external references are used, the 
object code size of F ILENAME2- OBJ 1 1 be calculated, and then 
all relocatable addresses used by FILENAMES. OBJ will be relo- 
cated to produce the equivalent of FILENAME3 - OBJ stacked on top 
of FILENAMES. OBJ - The result will be a file with the same na*e 
as the first input file, and with an extension as determined by 
the Linker used, with all external addresses relocated to a f £ lii 
that would be the tquaval.-nt of F ILENAME2 . OBJ and FILENAME3. OBJ 
stacked together- The output however will consist of only the 
file FILENAME 1 • OBJ . As many Reference Files as desired may be 
included in the link (as long as the 128 file limit is not 
exc« edtd) and may be stacked, calculated with separate load 
addresses or both- The same holds true for the files that are to 
be included in the output file- They may be stacked, specified 
with separate load addresses or both. 

In the above example, the Data sections followed the same 
attributes as the Code sections, i . e- if the Code section 
Reference Only, so was the Data section. Both Code and Data 
sections may be specified independently, so that Code may be 
Reference Only, but not Data, or Data may be Reference Only, but 
not Code. 
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TSK FILE TO INTEL HEX FORMAT CONVERTER 

The 2500 A.D. TSK File to Intel Hex Format Converter Nil! 
convert an executable object code file to the Intel hex tor («2t. 
It is intended to be used in conjunction with files output by 
LINK! (See the section enttitled 'Linker Description" for 
explanation of LINK] 5 . The file output by HEX may be much larger 
than the actual program itself. This is due to the fact that %hm 
smallest input file i ze is one record, i.e. 12S bytes- This 
then gets converted to twice the size, re* ilting in 25t> bytes. 
Since dditional information like start characters, load 
addresses and checksums are also included, the smallest *ila 
output from this converter is 3 records long- If exact sizes are 
required, LINK2 should be used. 



To run the Converter type : HEX 

The Converter will respond with the following prompts 

ENTER INPUT FILENAME ; 

If no input filename extension is given, the Converter hi 1 i 
default to TSK- The output file will have the same name as the 
input filename, but with an extension of HEX . 

After the user enters the input f ilenanie, the Converter wi i i 
ask for the starting address. This is the ad; ress that the code 
actually runs at, and is coded into the output file. 



The Intel Hex Format is described bel gw. 

Record Mark Field - T> i s field signifies the start of a re- 

cord, and consists of an Ascii colon •:>. 



Record Length Field - This field consists of two Asci i charac- 
ters which indicate the number of d=ta 
bytes in this record- Tne characters are 
the result of converting the number or 
data bytes in binary to two Ascii charac- 
ters, high digit first. An end of rile 
record contains two Ascii zeros in this 
field. The max 1 mi m number of data bytes 
in a record is 255- This converter uses 
32 data bytes per record. 
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Load Address Field - This -field consists of the four Asci i 

characters which result from converting 
the binary value of the address in which 
to begin loading this record- The order 
is i«s fallows: 

High digit of high byte of address. 
Low digit of high byte of address- 
High digit of low byte of adtire^^. 
Low digit of low byte of address. 

In an tvnd of file record, this fiaid 
consists of ei tfier four Ascii zeros, ur 
the program entry address. Since the 
Converter does not know the program » itry 
addre- s, this field will always be j rcE 
in an end of file record. 



Record Type Field — This field identifies the record type, 

which is either OO for data records or 01 
for an end of file record. It cDnsi^^ 
of two Asci i characters, with the high 
digit of the record type first, followed 
by the low digit of the record type- 



Data Field - This fie j consists of the actual data, 

converted to two Ascii characters, high 
digit first- There are no data byres in 
the end of file record. 



Checksum Field - The checksum field is the 6 bit binary 

sum of the fa ~ord length field, the load 
address field, the record type field and 
the data field- This sum is then negated 
(2*s complement) and converted to t*-c? 
Ascii characters, high digit first. 
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LOWER TO UPPER CASE SOURCE CODE CONVERTER 

The 2500 A. O. Lower to Up.ier Case Source Code Converter will 
convert all characters in a file -From lower to upper case except 
for strings enclosed in apostrophes. If the string contains an 
apostrophe, this can be specified with two apostrophes in a r^?-. 
This rule is consistent with most assemblers. 



f'l run the Converter type : CASE 

The Converter will respond with the following prompt. 

EN7TTR SOURCE CODE INPUT FILENAME : 

"fter the user enters the input filename the Converter will 
display the output filename pre ipt as shown elow. 

■ 

ENTER SOURCE CODE OUTPUT FILENAME : 



After this, the Converter will display e^ch converted line 
at the terminal. 
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